home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 5 / BBS in a Box -Volume V (BBS in a Box) (April 1992).iso / Files / System7 tools / P-Q / PWRSWITCHER 1.0.cpt / PWRSWITCHER 1.0 Folder / PwrSwitcher 1.0 / PwrSwitcher Instructions < prev    next >
Text File  |  1991-11-12  |  10KB  |  164 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. PwrSwitcher is a System 7 control panel that lets you change from one active application to another using your keyboard instead of the Finder’s application menu.
  10.  
  11.  
  12.  
  13.  
  14. This is PwrSwitcher 1.0 final — functionally identical to 1.0b2, but several hundred bytes smaller. 
  15.  
  16. I’ve included an alternate version, called PwrSwitcher NC. The NC alternative has the feature of not requiring the use of the Control key to cycle forward through your applications. Most people won’t have any problem with the NC version. However, I’d prefer that you get used to pushing the Control key — the NC version will cause some applications (Excel, Illustrator, maybe others) to “switch out” of the foreground.
  17.  
  18. The control panel has balloon help and checkboxes that allow you to customize PwrSwitcher to your tastes — at least with respect to being able to cycle through hidden applications, putting up the dialog that tells you PwrSwitcher can’t switch, and showing the icon at startup. Settings are saved in the Preferences folder. The checkboxes will be dimmed if you haven’t booted your machine with PwrSwitcher installed.
  19.  
  20.  
  21.  
  22.  
  23. What do you need to use PwrSwitcher? System 7, enough memory so you can run more than one application, and the right keyboard. PwrSwitcher is set up to use the Power key on a keyboard so equipped, or the ‘esc’ key on a Portable. You can’t use PwrSwitcher on the early keyboards that attach by way of a modular telephone connector.
  24.  
  25.  
  26.  
  27.  
  28. How do you install PwrSwitcher? Drag the PwrSwitcher icon to your System Folder and let the Finder put it into the Control Panels folder. Then restart your Macintosh.
  29.  
  30.  
  31.  
  32.  
  33. PwrSwitcher will be in your Control Panels folder. Most people can get to their control panels from the Apple menu, like this:
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48. When you double–click on the PwrSwitcher icon, you’ll see a summary of PwrSwitcher keystrokes. Remember this so you don’t have to keep coming back to these instructions.
  49.  
  50. How does PwrSwitcher work? I’ll show you with an example. Let’s assume I’ve opened these applications in the following order: Finder (opened by System 7 at startup), DarkSide, MPW Shell, MORE 3.0, THINK Pascal, TeachText, and MacDraw. Also assume that I’ve hidden DarkSide. At this point, the Finder’s application menu looks like this:
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. Notice that there is a check mark next to Finder — this is the “current” application. The current application’s windows are in front of all other windows, and its menus are in the menu bar.
  68.  
  69. Each time I hold down the Control key and press the Power key (the unmarked key with the sideways triangle embossed in its surface), the current application changes: MPW Shell the first time, then MORE 3.0, THINK Pascal after that, then TeachText, and finally MacDraw. (From now on, rather than saying “hold down the Control key and press the Power key,” I’ll say “press Control–Power” instead. The same contraction will apply for other keys besides the Control key. Also, Macintosh Portable users should substitute ‘esc’ for Power.) The next time I press Control–Power, the Finder becomes current once again. The applications became current in the same order they were opened.
  70.  
  71. You may have noticed that DarkSide never became the current application as I repeatedly cycled using Control–Power. That’s because DarkSide is hidden, and PwrSwitcher never makes a hidden application visible.
  72.  
  73. Now let’s suppose I make the Finder current and select “Hide Others” from the application menu. The application menu now looks like this:
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90. The only visible application is the Finder. When I next press Control–Power, I see this message:
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104. Remember that if you don’t like to see this reminder, you can turn it off using the PwrSwitcher control panel.
  105.  
  106. OK, that covers the basics of PwrSwitcher operation. The next section covers some advanced features.
  107.  
  108.  
  109.  
  110.  
  111. If that was all PwrSwitcher did, you’d probably have to establish certain work habits to make it useful. You should always remember that (as initially configured, although you can change this behavior using the control panel) PwrSwitcher only cycles through applications which have not been hidden by the Finder. You can take advantage of this when you find yourself switching among only a few of your active applications — simply hide the applications you’re not using at the moment, and let PwrSwitcher cycle through the ones you’re actively using.
  112.  
  113. PwrSwitcher can do other things. Let's go back to my example, and say I’m copying paragraphs from TeachText into MacDraw. Take a look back at the order in which I opened my applications: Finder, DarkSide, MPW Shell, MORE 3.0, THINK Pascal, TeachText, and MacDraw. If all my applications were visible, I would have to press Control–Power once to get from TeachText to MacDraw, and six times to get from MacDraw back to TeachText. Those six keypresses would drive me to distraction after a while…
  114.  
  115. Here’s Secret #1: PwrSwitcher cycles in reverse order when you press Shift–Control–Power. This means that I can cycle from TeachText to MacDraw by pressing Control-Power, and back to TeachText by pressing Shift–Control–Power.
  116.  
  117. Life, however, is never as simple as examples in instruction manuals. Let’s say that I have the same list of visible applications as before, and want to switch back and forth between MORE 3.0 and TeachText. I can go foward in the cycle with two presses of Control–Power, and backward (using Secret #1) with two presses of Shift–Control–Power. After doing this a few times, I notice that I have to watch all the THINK Pascal windows redraw each time I want to go from MORE 3.0 to TeachText or vice versa. This annoys me…
  118.  
  119. That’s why we have Secret #2: PwrSwitcher “marks” an application when you press Shift–Option–Control–Power. When you do this, the current application stays current. It looks like nothing happens. Behind the scenes, though, PwrSwitcher remembers the “marked” application.
  120.  
  121. By itself, Secret #2 is of little value. Even so, let’s say I just marked MORE 3.0, after which (using either PwrSwitcher or the application menu) I made TeachText the current application. Secret #3 completes the picture: When you press Option–Control–Power, PwrSwitcher does something very special (and a bit more difficult to explain). The Option–Control–Power combination “swaps” from an “alternate” application to the “marked” application (or vice versa).
  122.  
  123. What is the alternate application? It is the current application (IF OTHER THAN THE MARKED APPLICATION) at the time you press Option–Control–Power. Let’s get back to my example: I’ve marked MORE 3.0 and made TeachText the current application. Now, when I press Option–Control–Power, TeachText becomes the “alternate” and PwrSwitcher makes MORE 3.0 (the “marked” application) current. When I press Option–Control–Power again, PwrSwitcher makes the “alternate” application current again. If you don’t understand this, read the last few paragraphs again — this is really useful once you get the hang!
  124.  
  125.  
  126.  
  127.  
  128. If you still have an alpha version (dated prior to September 26, 1991) of PwrSwitcher, you should be sure to remove it from your Extensions folder. The final version belongs in your Control Panels folder. To see the new icon, you may have to “rebuild your desktop” by holding down the ‘Option’ and ‘Command’ keys just before the Finder draws the desktop as your system starts up.
  129.  
  130. PwrSwitcher reads some undocumented System 7.0 data structures to find out whether an application is hidden by the Finder. Technically, this is a BAD THING to do — but I’ve been very careful. When some future release of the system software changes these structures, PwrSwitcher may “forget” how to skip over hidden applications; it should not cause your system to crash.
  131.  
  132. I welcome your comments and suggestions. You can reach me on America Online as DBLamkins. On FidoNet you can send NetMail to David Lamkins at 1:101/640.14 — I also follow the MacDev and System7 echoes.
  133.  
  134.  
  135.  
  136.  
  137. I owe a debt of gratitude to W. J. Bock for his system extension, Switch, which sparked the idea for PwrSwitcher. I also want to thank the hundreds of users who took a chance with the alpha versions of PwrSwitcher. PwrSwitcher has advanced to its present state thanks to the dozens of challenging and insightful comments from users. I may add more user–suggested enhancements in a future release.
  138.  
  139.  
  140.  
  141.  
  142. The name of this product is PwrSwitcher, not PowerSwitcher.
  143.  
  144. PwrSwitcher is absolutely free. PwrSwitcher may be distributed so long as it includes this documentation. PwrSwitcher may not be sold. I retain all rights to PwrSwitcher. The user must assume all risk of loss resulting from use of PwrSwitcher.
  145.  
  146. Trademarks used herein are the property of their respective owners.
  147.  
  148.  
  149.  
  150.  
  151. 1.0a1 — First public release.
  152. 1.0a2 — Added backwards cycle function. Ignored Control key to aid compatibility with RadiusWare Cursor Beacon.
  153. 1.0a3 — Added mark/swap functions. Added Finder help balloon.
  154. 1.0a4 — Added code to skip hidden layers. This version is designed not to load under System 7.1 or later (as a fail–safe for the hidden application detection code).
  155. 1.0a5 — Added color Finder icons. No longer confused as to the visibility of multiple copies of the same program. Changed the fail–safe mechanism so PwrSwitcher can continue to load under System 7.1 and later (although hidden application detection may not continue to work).
  156. 1.0b1 — Changed from extension to control panel. Added support for Macintosh Portable using ‘esc’ key as substitute for Power key. Rewrote documentation.
  157. 1.0b2 — Control panel now has preference controls and help balloons. Must use Control key with all key combinations. Known to fix “switch out problem” with Adobe Illustrator 3.0 (probably also fixes less severe problem with Microsoft Excel 3.0).
  158. 1.0 — This release. The end of the line for the forseeable future. Removed MacsBug symbol names from code to save several hundred bytes. Bundled “NC” variant which doesn’t require use of Control key.
  159.  
  160.  
  161.  
  162. Quite a few people have suggested that they’d be willing to pay for PwrSwitcher as a shareware product. I never planned to sell PwrSwitcher — I consider it a simple hack (well, it was simple once) — and am loath to take advantage of people’s good intentions.
  163.  
  164. If you want to make a contribution to express your appreciation of PwrSwitcher, please consider a charitable donation to Beverly Hospital, Beverly, MA 01915 (USA) in memory of Dr. Burnham E. Lamkins. The decision to do so is entirely at your discretion.